home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat3 / PrintDbl.3 < prev    next >
Text File  |  1994-09-20  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tcl_PrintDouble(3)   Tcl Library Procedures                   7.0
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      Tcl_PrintDouble - Convert floating value to string
  12.  
  13. SYNOPSIS
  14.      #include <tcl.h>
  15.  
  16.      Tcl_PrintDouble(_i_n_t_e_r_p, _v_a_l_u_e, _d_s_t)
  17.  
  18. ARGUMENTS
  19.      Tcl_Interp   *_i_n_t_e_r_p   (in)      Interpreter  that  controls
  20.                                       the conversion.
  21.  
  22.      double       _v_a_l_u_e     (in)      Floating-point value to  be
  23.                                       converted.
  24.  
  25.      char         *_d_s_t      (out)     Where   to   store   string
  26.                                       representing  _v_a_l_u_e.   Must
  27.                                       have        at        least
  28.                                       TCL_DOUBLE_SPACE characters
  29.                                       of storage.
  30. _________________________________________________________________
  31.  
  32.  
  33. DESCRIPTION
  34.      Tcl_PrintDouble generates a string that represents the value
  35.      of  _v_a_l_u_e  and  stores it in memory at the location given by
  36.      _d_s_t.  It uses %g format to generate  the  string,  with  two
  37.      special  twists.  First, the string is guaranteed to contain
  38.      either a ``.'' or an ``e'' so that it doesn't look  like  an
  39.      integer  (where %g would generate an integer with no decimal
  40.      point, Tcl_PrintDouble adds ``.0'').  Second, the number  of
  41.      significant  digits  printed  at  _d_s_t  is  controlled by the
  42.      tcl_precision variable in _i_n_t_e_r_p;  if tcl_precision is unde-
  43.      fined then 6 significant digits are printed.
  44.  
  45.  
  46. KEYWORDS
  47.      conversion, double-precision, floating-point, string
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Tcl                                                             1
  64.  
  65.  
  66.  
  67.